Skip to content

fix: update webtransport-go to v0.11.1 - #3532

Merged
sukunrt merged 2 commits into
masterfrom
chore/update-quic-go-v0600
Jul 27, 2026
Merged

fix: update webtransport-go to v0.11.1#3532
sukunrt merged 2 commits into
masterfrom
chore/update-quic-go-v0600

Conversation

@lidel

@lidel lidel commented Jul 27, 2026

Copy link
Copy Markdown
Member

Problem

go-libp2p ships webtransport-go v0.10.0, which has two problems.

Memory exhaustion. Already-public GHSA-g35j-m5xg-vh3q (CVE-2026-57497): unknown WebTransport capsules are read with io.ReadAll, so a peer can make the receiver buffer an arbitrarily large capsule body.

Browser interop is aging out. WebTransport is here so browsers can reach a go-libp2p node. Browsers only dial, never listen, so browser to go-libp2p is the direction worth optimising for. v0.10.0 speaks only the oldest version of the handshake, and omits a setting Safari 26.4+ wants (quic-go/webtransport-go#262).

Fix

webtransport-go v0.11.1 plus quic-go v0.60.0, which v0.11.1 requires. No source changes, since v0.11.1 still exports Dialer.

Browsers keep working, current and future ones

WebTransport over HTTP/3 is still an IETF draft, draft-ietf-webtrans-http3, and libp2p builds on it (libp2p WebTransport spec). A session identifies itself with two values on the wire: an Extended CONNECT :protocol token, and an HTTP/3 SETTINGS codepoint. Version 15 of the draft (March 2026) renamed both:

  • token webtransport becomes webtransport-h3
  • setting 0x2b603742 becomes 0x2c7cf000

v0.11.1's server sends and accepts both spellings, so it answers either generation of client:

  • Today's browsers keep working. Chrome (since 97, Jan 2022), Firefox (since 114, June 2023) and Safari (since 26.4, March 2026) all still send the old pair. Chrome has not started on the new one: neither webtransport-h3 nor 0x2c7cf000 appears anywhere in quiche.
  • Tomorrow's browsers work too. Firefox is implementing the new pair right now in draft 15 support mozilla/neqo#3646. Once that ships, v0.10.0 would stop answering it. v0.11.1 already does.
  • Safari gets better today. v0.11.1 sends the SETTINGS_WT_MAX_SESSIONS value Safari 26.4+ expects and v0.10.0 never sent.

So this is the change that keeps browsers able to reach go-libp2p, rather than one that risks it.

The go-to-go regression, which does not matter

A node on v0.11.x can no longer dial a peer still on v0.10.0 over WebTransport. The reverse still works: old peers can dial this node fine.

We do not care. Go to go connections use /quic-v1, which every node announces on the same UDP port, and the dial ranker prefers it over WebTransport anyway. WebTransport is there for browsers, and browsers are unaffected. It also resolves itself as the network upgrades.

Verified with a real browser: Firefox 153 via @libp2p/webtransport completes a full dial against a v0.11.1 listener.

webtransport-go v0.11.1 fixes CVE-2026-57497 / GHSA-g35j-m5xg-vh3q,
unbounded buffering of unknown WebTransport capsules. A peer could
send a large capsule of an unrecognized type and make the receiver
hold the whole body in memory. v0.11.1 drains it to io.Discard.

v0.11.1 requires quic-go v0.60.0, so quic-go moves with it.

v0.11.x speaks WebTransport draft-15: the client sends the
webtransport-h3 :protocol token and SETTINGS_WT_ENABLED, and no
longer accepts a server that advertises only the draft-06 codepoint.
Dialing a peer on webtransport-go v0.10.0 or older will fail. Inbound
sessions from those peers still work, since the server accepts both
generations, and browsers are unaffected.
This was referenced Jul 27, 2026
@lidel
lidel requested a review from sukunrt July 27, 2026 17:07
webtransport-go v0.11.1 speaks a newer WebTransport draft, so
go-libp2p-head cannot dial peers still on the older one. Browser to
go-libp2p is unaffected, which is the direction WebTransport exists
for, and go to go falls back to /quic-v1.

Also drops the go-v0.45 entry, which no longer exists in the interop
matrix.
@lidel
lidel marked this pull request as ready for review July 27, 2026 17:31
@lidel lidel mentioned this pull request Jul 27, 2026
@sukunrt
sukunrt merged commit 07d71d8 into master Jul 27, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants